home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / Tools / 1STGUIDE / 1STGUIDE.ENG < prev    next >
Encoding:
Text File  |  1997-06-10  |  9.2 KB  |  252 lines
  1. 1STGUIDE Release Notes                             Halle, Jun 10 1997
  2.  
  3.     Copyright (C) 1990-1997 Guido Vollbeding <guivol@esc.de>
  4.  
  5.  
  6.     Introduction:
  7.     -------------
  8.  
  9. 1stGuide is a program/accessory to view/play the following standard
  10. file formats in GEM windows on all Atari machines, all system
  11. configurations, in all screen resolutions and color depths
  12. (1 Bit Monochrome up to 32 Bit TrueColor):
  13.  
  14.     .IMG    GEM-(X/T)-Image picture files, Level-1/2/3
  15.         (1 Bit Monochrome up to 12 Bit RGB XIMG Colormap,
  16.         RGB-TrueColor/Gray/Alpha TIMG direct pixel)
  17.     .IFF    Interchange File Format: ILBM - Interleaved Bitmaps
  18.         (1 Bit Monochrome up to 12 Bit RGB Colormap)
  19.     .GEM    GEM-Metafiles (including bezier curves under
  20.         appropriate VDI, e.g. NVDI >= 2.12)
  21.     .RSC    GEM-Resource files
  22.         (simple up to 64 K and extended > 64 K)
  23.     .PNG    Portable Network Graphics, all 'flavors'
  24.         according to the current specification
  25.     .JPG
  26.     .JPE
  27.     .JPEG   Joint Photographic Experts Group - pictures:
  28.         JPEG/JFIF-Standard (24 Bit TrueColor, 8 Bit Gray),
  29.         Baseline/Multiscan/Progressive Support
  30.     .MPG
  31.     .MPE
  32.     .MPEG   Moving Picture Experts Group - movies:
  33.         MPEG-1-Video-Standard (24 Bit TrueColor),
  34.         MPEG-1-System (Video+Audio interleaved)
  35.     .SAM
  36.     .SND
  37.     .AVR    Sound-Sample files
  38.         (8 Bit Mono only at the moment)
  39.     .DOC
  40.     .OUT
  41.     *       Textfiles (including attributes)
  42.  
  43. Furthermore, hypertext-like links can be defined between files in
  44. a simple manner, which provides the possibility to create large
  45. information systems to be used interactively with 1stGuide.
  46. See in the program description for details.
  47.  
  48. Note: By pressing Control-A (or holding down the right mouse key by
  49. clicking in the Acc-Menu) you get a configuration dialog to set your
  50. preferences.
  51. Here is a short description of the "Image-Dithering" option:
  52. With "Niemals" (Never) dithering is 'normally' (see below) not used.
  53. At "Bedarf" (Need) images are only dithered if containing more colors
  54. than are available in the current screen resolution. Otherwise, the
  55. color palette must be changed by hand (Popup/Shortcuts ^E, ^S).
  56. If you select "Immer" (Always), images containing a color palette
  57. will always be dithered (except in High-/True-Color modes).
  58. Advantages:
  59.     - no need to change the hardware palette;
  60.     - multiple pictures are displayed in right colors
  61.       at the same time.
  62. Disadvantages:
  63.     - not optimal display (dithering to a fix palette);
  64.     - higher computing costs -> longer waiting time
  65.       at loading.
  66. Simply try this out! This option is not used in High-/True-Color
  67. modes and is only used for XIMG/IFF-pictures, not for JPG/PNG/TIMG.
  68.  
  69.  
  70.     Installation for Atari ST(E)/TT/Falcon etc.:
  71.     --------------------------------------------
  72.  
  73. 1. Copy the file 1STGUIDE.ACC into your Boot-Directory. If you want
  74.    to print with 1stGuide, an appropriate version of GDOS must be
  75.    installed.
  76.  
  77. The following steps apply only for installing the full package:
  78.  
  79. 2. Create a new folder (e.g. "1STGUIDE") on your harddisk, and copy
  80.    or decompress the disk contents into that folder.
  81.  
  82. 3. Reboot the system, click in the Desk-Menu on the entry "1st Guide"
  83.    and choose the file "1STGUIDE.HLP" with the upcoming file-selector
  84.    in your installation directory. There you will get further
  85.    instructions.
  86.  
  87. Additionaly you can insert the following line in your DESKTOP.INF or
  88. NEWDESK.INF file to avoid getting the alert "Show/Print/Cancel" by
  89. the desktop:
  90.  
  91. #G 03 04 C:\1STGUIDE.ACC@ *.*@
  92. respectively
  93. #G 03 04 000 C:\1STGUIDE.ACC@ *.*@ @
  94.  
  95. If you insert the following line after this, you can start 1STGUIDE
  96. (and certain other, also inactive, accessories) immediately as a
  97. program:
  98.  
  99. #G 03 FF *.AC*@ @
  100. respectively
  101. #G 03 FF 000 *.AC*@ @ @
  102.  
  103. Alternatively, you can rename 1STGUIDE into .PRG, .APP, or .GTP for
  104. use as a program.
  105.  
  106.  
  107.     Contents of the package:
  108.     ------------------------
  109.  
  110. The 1stGuide full package contains the following parts:
  111.  
  112.     - 1STGUIDE.ZIP, containing the program file 1STGUIDE.ACC,
  113.             this english textfile 1STGUIDE.ENG, and
  114.             the german description 1STGUIDE.GER;
  115.  
  116.     - GUIDHELP.ZIP, containing detailed program description
  117.             and TOS/GEM-System-Documentation in
  118.             hypertext form;
  119.  
  120.     - GUIDTOOL.ZIP, containing utility programs for use with
  121.             1stGuide, a printable description in TeX as
  122.             DVI-file, and 1stView including sources;
  123.  
  124.     - GUIDDOSE.ZIP, containing program versions for the PC-GEM.
  125.  
  126. Furthermore, the following packages are available:
  127.  
  128.     - JPEG_DSP: contains DSP-JPEG-Decode-Driver for the Falcon;
  129.  
  130.     - JPEG_GVS: contains the JPEG-Save-Module for GEM-View 3.x;
  131.  
  132.     - MPEGDSP.TTP: DSP-MPEG-Player-Demoprogram for the Falcon;
  133.  
  134.     - MPEG_SYS: contains a tool for MPEG-1-System-Layer-Streams;
  135.  
  136.     - XIMGTOOL: sources/tool/modules for (X/T)IMG-Level-1/2/3.
  137.  
  138. For distribution AT LEAST the archive 1STGUIDE.ZIP or it contents
  139. (1STGUIDE.ACC, 1STGUIDE.ENG, 1STGUIDE.GER) is necessary, other parts
  140. are OPTIONAL!
  141. The full package is available automatically after registration.
  142. If you are NOT able to deal with HD-disks, please note this at
  143. registration. In this case some optional parts must be left.
  144. Normally I send HD-disks!
  145.  
  146.  
  147.     Registration:
  148.     -------------
  149.  
  150. 1stGuide is SHAREWARE!! This means, that a registration by sending
  151. the shareware fee to the author is necessary, if you decide to use
  152. the program regularly, and if you are interested in further
  153. extensions and enhancements.
  154.  
  155. The shareware fee for 1stGuide is 50,- DM (Deutsche Mark). Please
  156. send this fee to the following address:
  157.  
  158.     Guido Vollbeding
  159.     Turmstrasse 61
  160.     D-06110 Halle (Saale)
  161.     Germany
  162.  
  163. After receiving the money I will send you a master disk containing
  164. the current packages, and you can feel free to order actual versions
  165. later by sending a letter with disk and return portage.
  166.  
  167. If somebody uses 1stGuide without paying the fee, she/he should keep
  168. in mind that she/he violates rights and rules of well behavior.
  169.  
  170.  
  171.     Declaration:
  172.     ------------
  173.  
  174. 1stGuide is a shareware program package from:
  175.  
  176.     Guido Vollbeding
  177.     Turmstrasse 61
  178.     D-06110 Halle (Saale)
  179.     Germany
  180.  
  181. All rights reserved. I accept NO LIABILITY for damages of any kind.
  182.  
  183. -!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-
  184. This software is based in part on the work of the Independent JPEG
  185. Group, Copyright (C) 1991-1996, Thomas G. Lane.  All Rights Reserved.
  186. The authors accept NO LIABILITY for damages of any kind.
  187. -!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-
  188.  
  189. ~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~
  190. This software supports the DSP-JPEG-Decoder from Brainstorm, France,
  191. for Atari Falcon computers, which is copyright (C) 1992-1993 by
  192. Brainstorm & Atari Corporation.
  193. ~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~
  194.  
  195. -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-
  196. The MPEG part of this software is based in part on the work of
  197.  
  198.             Lawrence A. Rowe, Ketan Patel, and Brian Smith
  199.      Computer Science Division-EECS, Univ. of Calif. at Berkeley
  200.  
  201. Copyright (C) 1995 The Regents of the University of California.
  202. All rights reserved.
  203.  
  204. IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY
  205. FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  206. ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
  207. IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY
  208. OF SUCH DAMAGE.
  209.  
  210. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
  211. INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  212. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE
  213. PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF
  214. CALIFORNIA HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT,
  215. UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  216. -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-
  217.  
  218. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
  219. The PNG part of this software is based in part on the work of
  220.  
  221.   Guy Eric Schalnat, Group 42, Inc., Copyright (c) 1995-1996
  222.   Contributing Authors:
  223.     Guy Eric Schalnat
  224.  
  225.   The PNG Reference Library is supplied "AS IS". The Contributing
  226.   Authors and Group 42, Inc. disclaim all warranties, expressed or
  227.   implied, including, without limitation, the warranties of
  228.   merchantability and of fitness for any purpose. The Contributing
  229.   Authors and Group 42, Inc. assume no liability for damages,
  230.   direct or consequential, which may result from the use of
  231.   the PNG Reference Library.
  232.  
  233. and the 'zlib' general purpose compression library:
  234.  
  235.   Copyright (C) 1995-1996 Jean-loup Gailly and Mark Adler
  236.  
  237.   This software is provided 'as-is', without any express or implied
  238.   warranty.  In no event will the authors be held liable for any
  239.   damages arising from the use of this software.
  240.  
  241. PNG Spec. 1995 by Thomas Boutell, Mark Adler, and Lee Daniel Crocker.
  242. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
  243.  
  244. The software may be freely distributed, as long as all files of a
  245. single package remain together and unchanged.
  246. Any commercial distribution (including PD-Series or so) is strictly
  247. excluded, unless given my written agreement. Appropriate conditions
  248. can be asked from the author AFTER registration!
  249.  
  250. Now I wish you much fun with 1stGuide, and may the Atari always be
  251. with you!
  252.